Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Application Messages

GXFinishJob

QuickDraw GX sends the GXFinishJob message when the spooling of a document is finished. You can override the GXFinishJob message to perform operations required by your printing extension or printer driver at the completion of spooling a document. Your override of the GXFinishJob message must match the following formal declaration:

OSErr MyFinishJob (void);

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the GXFinishJob message when an application calls the GXFinishJob function to indicate that spooling of a document is complete.

You need to override this message if you want to know when a document has finished spooling or to finalize information when spooling of a document is done.

The default implementation of GXFinishJob completes the spooling process by sending spooling messages. It also updates the job object data to contain the correct number of pages that are to be printed. It sends spooling messages to accomplish this.

SPECIAL CONSIDERATIONS

You never send the GXFinishJob message yourself.

You must forward the GXFinishJob message to other message handlers.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The GXFinishJob function is described in Inside Macintosh: QuickDraw GX Printing.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help